<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>注解语法</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="language.attributes.overview.html">« 注解概览</a></li>
      <li style="float: right;"><a href="language.attributes.reflection.html">使用反射 API 读取注解 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="language.attributes.html">注解</a></li>
    <li>注解语法</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="language.attributes.syntax" class="sect1">
   <h2 class="title">注解语法</h2>

   <p class="para">
    注解语法包含以下几部分。
    首先，注解声明总是以 <code class="literal">#[</code> 开头，以
    <code class="literal">]</code> 结尾来包围。
    内部则是一个或以逗号包含的多个注解。
    注解的名称按 <a href="language.namespaces.basics.html" class="link">使用命名空间：基础</a> 
    章节中描述，可以是非限定、限定、完全限定的名称。
    注解的参数是可以选的，以常见的括号<code class="literal">()</code>包围。
    注解的参数可以是字面值或者常量表达式。
    它同时接受位置参数和命名参数两种语法。
   </p>

   <p class="para">
    通过反射 API 请求注解实例时，注解的名称会被解析到一个类，注解的参数则传入该类的构造器中。
    因此每个注解都需要引入一个类。
   </p>

   <div class="example" id="example-350">
    <p><strong>示例 #1 注解语法</strong></p>

    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">//&nbsp;a.php<br /></span><span style="color: #007700">namespace&nbsp;</span><span style="color: #0000BB">MyExample</span><span style="color: #007700">;<br /><br />use&nbsp;</span><span style="color: #0000BB">Attribute</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">#[Attribute]<br /></span><span style="color: #007700">class&nbsp;</span><span style="color: #0000BB">MyAttribute<br /></span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;</span><span style="color: #0000BB">VALUE&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'value'</span><span style="color: #007700">;<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;private&nbsp;</span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;public&nbsp;function&nbsp;</span><span style="color: #0000BB">__construct</span><span style="color: #007700">(</span><span style="color: #0000BB">$value&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">null</span><span style="color: #007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">value&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br />}<br /><br /></span><span style="color: #FF8000">//&nbsp;b.php<br /><br /></span><span style="color: #007700">namespace&nbsp;</span><span style="color: #0000BB">Another</span><span style="color: #007700">;<br /><br />use&nbsp;</span><span style="color: #0000BB">MyExample</span><span style="color: #007700">\</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">#[MyAttribute]<br />#[\MyExample\MyAttribute]<br />#[MyAttribute(1234)]<br />#[MyAttribute(value:&nbsp;1234)]<br />#[MyAttribute(MyAttribute::VALUE)]<br />#[MyAttribute(array("key"&nbsp;=&gt;&nbsp;"value"))]<br />#[MyAttribute(100&nbsp;+&nbsp;200)]<br /></span><span style="color: #007700">class&nbsp;</span><span style="color: #0000BB">Thing<br /></span><span style="color: #007700">{<br />}<br /><br /></span><span style="color: #FF8000">#[MyAttribute(1234),&nbsp;MyAttribute(5678)]<br /></span><span style="color: #007700">class&nbsp;</span><span style="color: #0000BB">AnotherThing<br /></span><span style="color: #007700">{<br />}</span>
</span>
</code></div>
    </div>

   </div>
  </div></div></div></body></html>